home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / lastc_10.arc / LASTCALL.DOC next >
Text File  |  1991-09-26  |  9KB  |  392 lines

  1.                                   25-SEP-1991
  2.  
  3.  
  4.  
  5.                              LastCall Version 1.00
  6.  
  7.                       A BINKLEY.CLD File Analysis Utility
  8.                            Author: Steven K. Shapiro
  9.  
  10.                               SysOp LoneStar CBCS
  11.                                 FidoNet 1:382/35
  12.                                  (512) 258-3643
  13.  
  14.                            Program and Documentation
  15.                 Copyright (C) 1991 SKS Computer Consulting, Inc.
  16.                               All Rights Reserved
  17.  
  18.  
  19.  
  20.                     LastCall IS NOT PUBLIC DOMAIN SOFTWARE!
  21.  
  22.                        LastCall IS COPYRIGHTED SOFTWARE.
  23.  
  24.                    YOU ARE ENTITLED TO USE AND DISTRIBUTE THE
  25.                LSTFMT PACKAGE ONLY IN ACCORDANCE WITH THE LICENSE
  26.                           AGREEMENT CONTAINED HEREIN.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                                   25-SEP-1991
  67.  
  68.  
  69.  
  70.      LICENSE AGREEMENT, WARRANTY AND STATEMENT OF LIABILITY
  71.  
  72.      The  term  "the  package"  refers  to  the   LastCall   software   and
  73.      documentation,  individually  and collectively.  The term "the author"
  74.      shall be construed to mean Steven K.  Shapiro.
  75.  
  76.      The package is the exclusive property of the author, and is  protected
  77.      by  copyright  laws.   By  obtaining a copy of the package, you do not
  78.      "own" a copy...all property rights are retained by  the  author.   You
  79.      are merely licensed to USE it.
  80.  
  81.      This  License  grants limited rights to use and distribute the package
  82.      in accordance with the terms listed herein.  Any other use constitutes
  83.      a violation of the author's rights under United States Copyright  Law,
  84.      and applicable treaties.
  85.  
  86.      You  may  use the package and/or give copies of the package to others,
  87.      but only in a form that permits inclusion of all files as found in the
  88.      original, archived form in which the package  is  distributed  by  the
  89.      author.  You are not permitted to modify any portion of the package in
  90.      any  way,  including,  but  not limited to adding files to or removing
  91.      files   from   the  distribution  package,  changing  or  editing  the
  92.      documentation,   and/or   changing   or   modifying   the   executable
  93.      program(s).
  94.  
  95.      If you find the package to  be  of  use,  and  feel  that  a  monetary
  96.      contribution  is  in  order,  you  are encouraged to forward it to the
  97.      author.
  98.  
  99.      The package is not provided with any warranty of any kind,  including,
  100.      but not limited to fitness for any particular purpose.
  101.  
  102.      IMPORTANT NOTE:  If this License or any portion thereof is not legally
  103.      valid  in  your  geographical  area  or  jurisdiction, THIS LICENSE IS
  104.      WITHDRAWN and YOU ARE NOT LICENSED TO USE OR DISTRIBUTE THE PACKAGE!
  105.  
  106.      WARNING!  YOU USE THIS PACKAGE ENTIRELY AT YOUR OWN RISK!  The  author
  107.      will  NOT  be responsible for any loss of data, loss of business, loss
  108.      of monies or any other damages resulting from the use of, or inability
  109.      to use this  program.   By  operating  the  program,  you  accept  and
  110.      acknowledge responsibility IN FULL for all occurrences related to your
  111.      use  of  the  program.   In  any jurisdiction where such limitation of
  112.      liability is restricted or forbidden, this program IS NOT licensed for
  113.      legal use.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                        2
  131.                                   25-SEP-1991
  132.  
  133.  
  134.  
  135.      OTHER USES (NON-LICENSED USES)
  136.  
  137.      Use and distribution outside the scope of the License Agreement  above
  138.      is  strictly  prohibited, unless prior, written permission is obtained
  139.      from  the  author.   Inquiries  may  be  directed  to:   SKS  Computer
  140.      Consulting, Inc., P.O.  Box 202350, Austin, TX, 78720, USA.  Include a
  141.      self-addressed, stamped envelope for replies.
  142.  
  143.      DISTRIBUTION NOTICE
  144.  
  145.      The  package  may  be  posted for download or file request by any FTSC
  146.      compliant system in archived form, and in adherence to  the  terms  of
  147.      the  License  above.  No profit may be realized directly or indirectly
  148.      from such distribution, although  the  package  may  be  provided  for
  149.      download on 'pay systems'.
  150.  
  151.      ARCHIVES
  152.  
  153.      The  regular  distribution  version  of  the package is archived using
  154.      PKZIP from PKWare, Inc.  This is NOT a  political  statement,  it's  a
  155.      matter of personal preference.
  156.  
  157.      If  you  feel it necessary to re-archive the package in a format other
  158.      than the format it's delivered in, go ahead, but you should  read  the
  159.      License Agreement carefully.  Any distribution of the package requires
  160.      that ALL the files AS ORIGINALLY DISTRIBUTED must be included.
  161.  
  162.      Prior  to  distribution,  make  certain that you have a full, original
  163.      version, and make sure all the files in the package make it into  your
  164.      new archive.  Addition of files to the distribution is prohibited.
  165.  
  166.      PURCHASING COPIES OF THE PACKAGE
  167.  
  168.      The  package  is also available on diskette within the USA and Canada.
  169.      Send check or money order in US dollars to:  SKS Computer  Consulting,
  170.      Inc., P.O.  Box 202350, Austin, TX, 78720, USA.
  171.  
  172.      SOURCE CODE
  173.  
  174.      Source  code to the package will not be available.  I do not feel that
  175.      I need to justify my reasoning.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                        3
  196.                                   25-SEP-1991
  197.  
  198.  
  199.  
  200.      PROGRAM OPERATION
  201.  
  202.      LastCall provides the user the ability to  compare  the  values  in  a
  203.      BINKLEY.SCD  file  with  those  specified  as  input  arguments to the
  204.      LastCall program.
  205.  
  206.      This program was developed because the data structures were changed in
  207.      BinkleyTerm 2.50 from those in the previous version.  As such, I could
  208.      no longer use the utility which I had been using.   Unfortunately  the
  209.      author of that utility had disappeared so I was left without a program
  210.      like this.
  211.  
  212.      The initial release only provides the user with the ability to compare
  213.      the Network address against the BINKLEY.SCD file.  Future versions may
  214.      allow additional fields to be compared.
  215.  
  216.      The format for using LastCall is:
  217.  
  218.  
  219.      LASTCALL /I<input file>
  220.               /A<address>
  221.               /E<errorlevel>
  222.  
  223.      Where  all arguments are entered on the same line interactively or via
  224.      a batch file.  The arguments may occur in any order and all should  be
  225.      entered.   Failure  to  enter  any  or all command line arguments will
  226.      result in undesired results.
  227.  
  228.      /I<Input_file>
  229.  
  230.      This is the filename of the BINKLEY.SCD file from which to extract the
  231.      information.  If you fail to specify a fully  qualified  DOS  filename
  232.      (as  appropriate),  you're  out of luck because the program will abort
  233.      execution.
  234.  
  235.      /A<address>
  236.  
  237.      This is the network node address you which  to  check  against.   This
  238.      node number must be a fully qualified '3D' string of the form:
  239.  
  240.      zone:net/node
  241.  
  242.      If  you  fail to specify the node number properly the program will not
  243.      find a match and you will be out of luck.
  244.  
  245.      /E<errorlevel>
  246.  
  247.      This is the errorlevel which the program  should  use  when  it  exits
  248.      under a success condition.
  249.  
  250.      When  the  LastCall  comparison is UNSUCCESSFUL, an errorlevel of 0 is
  251.      returned.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                        4
  261.                                   25-SEP-1991
  262.  
  263.  
  264.  
  265.      EXAMPLES:
  266.  
  267.      1).  LASTCALL /ibinkley.scd /a1:382/35 /e123
  268.  
  269.      LASTCALL would analyse the file binkley.scd in the  current  directory
  270.      to  see  if  the  last  node which called was 1:382/35.  If it was, an
  271.      errorlevel of 123 is returned, if it wasn't, an errorlevel  of  9  was
  272.      returned.
  273.  
  274.      2).  LASTCALL /ic:\binkley\binkley.scd /e543 /a1:382/35
  275.  
  276.      LASTCALL  would  analyse  the  file  binkley.scd  in   the   directory
  277.      c:\binkley  to  see if the last node which called was 1:382/35.  If it
  278.      was, an errorlevel of 543 is returned, if it wasn't, an errorlevel  of
  279.      9 was returned.
  280.  
  281.      That's  pretty  much it.  If you have questions or comments, feel free
  282.      to contact me via my BBS as listed above.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                        5
  326.                                   25-SEP-1991
  327.  
  328.  
  329.  
  330.      HISTORY
  331.  
  332.      v1.00 09/25/1989
  333.  
  334.      This is the initial release of LastCall.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                        6
  391.  
  392.